Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Using Voice Mail, Paging, and Intercom Features

TELVoiceMailAccess

Accesses the voice-mail system of a private branch exchange (PBX).

pascal TELErr TELVoiceMailAccess (TELCAHandle hTELCA);

hTELCA

A handle you provide to the call appearance structure for the call to the voice mail system. You get the handle from the TELSetupCall function (page 4-24) or, if the user manually initiates the call, from the telCAOutgoingMsg message.

function result

A result code.

DESCRIPTION

The TELVoiceMailAccess function places a call to an implicit destination--the programmatic equivalent of a user pressing the voicemail button on a handset. As a result, you do not need to provide a destination number when you call the TELSetupCall function (page 4-24) to get a handle to a new call appearance structure.

The TELVoiceMailAccess function does not provide voice-mail management; it simply provides the ability to access a voice-mail system. For example, your application might call TELVoiceMailAccess after receiving the message telDNVoiceMailMsg.